TcaplusDB Benchmark Tool (Java) Instructions

1. Application Scenarios

The TcaplusDB Java Benchmark tool is mainly used for stress testing of TcaplusDB.

The TcaplusDB Java Benchmark tool supports stress testing using fixed data sets (CSV files) as well as stress testing using rules to generate random data dynamically.

The TcaplusDB Java Benchmark tool supports single request stress testing and multiple request mixed stress testing. Multiple request mix testing can configure the proportion of various requests. The request types supported by the current tool are:

  • TCAPLUS_CMD_GET_REQ
  • TCAPLUS_CMD_BATCH_GET_REQ
  • TCAPLUS_CMD_INSERT_REQ
  • TCAPLUS_CMD_DELETE_REQ
  • TCAPLUS_CMD_UPDATE_REQ
  • TCAPLUS_CMD_REPLACE_REQ
  • TCAPLUS_CMD_GET_BY_PARTKEY_REQ
  • TCAPLUS_CMD_INCREASE_REQ
  • TCAPLUS_CMD_LIST_GETALL_REQ
  • TCAPLUS_CMD_LIST_GET_REQ
  • TCAPLUS_CMD_LIST_ADDAFTER_REQ
  • TCAPLUS_CMD_LIST_REPLACE_REQ
  • TCAPLUS_CMD_LIST_DELETE_REQ
  • TCAPLUS_CMD_LIST_DELETE_BATCH_REQ
  • TCAPLUS_CMD_LIST_DELETEALL_REQ
  • TCAPLUS_CMD_DELETE_BY_PARTKEY_REQ
  • TCAPLUS_CMD_TABLE_TRAVERSE_REQ
  • TCAPLUS_CMD_LIST_TABLE_TRAVERSE_REQ

2. Limitations on Use

The TcaplusDB Java Benchmark tool relies on the TcaplusDB Java SDK to read and write data. Since the TcaplusDB Java SDK only supports access to TDR tables, TcaplusDB Java Benchmark can only perform performance tests based on TDR tables currently.

3. Instructions

3.1. Preparations

Install JDK. For the installation method, please refer to the official guidance of JDK manufacturers, such as the OpenJDK Installation Guidance.

Download the Benchmark tool. Please refer to Benchmark Tool Download for details.

3.2. Basic Test Method (Taking Linux as an example)

  1. Create a test directory (for example, the /data/ directory).

  2. Copy the tcaplus-benchmark directory in the Benchmark tool release package to the /data/ directory.

  3. Add a test table on the TcaplusDB OMS page. For table definitions, see /data/tcaplus-benchmark/example/test-table-for-benchmark.xml.

  4. Modify the contents of the /data/tcaplus-benchmark/example/test-workload-for-benchmark.yml file. The main modification points are:

4.1. Modify database configuration and set dir_servers, app_id, app_password and zone_id

4.2. Modify the value of each records parameter and modify the file path to: /data/tcaplus-benchmark/example/test-data-for-benchmark.yml.

  1. Start the test and execute the command:
java -cp /data/tcaplus-benchmark/lib/service-api-autotest-tool-3.40.0SP04.jar:/data/tcaplus-benchmark/conf/ com.tencent.tcaplus.autotest.tool.BenchMark -w /data/tcaplus-benchmark/example/test-workload-for-benchmark.yml

3.3. Customized Test Method

Users can edit their own test task profiles to perform customized tests in addition to performing basic tests using the sample tables and test task profiles included in the TcaplusDB Java Benchmark tool release package. For the test task profile setting method, refer to the test-workload-for-benchmark.yml file in the release package.

results matching ""

    No results matching ""